home *** CD-ROM | disk | FTP | other *** search
/ Creative Computers / Creative Computers CD-ROM, Volume 1 (Legendary Design Technologies, Inc.)(1994).iso / shareware / management / screenmod / screenmod.doc < prev    next >
Text File  |  1994-11-17  |  16KB  |  363 lines
  1.  
  2.  
  3.  
  4.                     ======================================
  5.                     =          ScreenMod v1.0            =
  6.                     =          ~~~~~~~~~ ~~~~            =
  7.                     =   Program and Documentation by:    =
  8.                     =          Syd L. Bolton             =
  9.                     =                                    =
  10.                     =          Copyright ©1991           =
  11.                     = Legendary Design Technologies Inc. =
  12.                     =       Freely Redistributable       =
  13.                     ======================================
  14.  
  15. WHAT IS SCREENMOD?
  16. ~~~~~~~~~~~~~~~~~~
  17.  
  18.     ScreenMod is a small utility program that was developed primarily
  19. to change the position of a custom screen opened by another program.  Some
  20. PAL utilities open their screens so low that most of the gadgets are
  21. unreachable by the mouse.  Using a PAL-BOOT program doesn't always help
  22. the situation.  Not everybody is able to permanently alter someone's
  23. executable code (especially if it's compressed in some form or another)
  24. and that is why ScreenMod came to life.
  25.     ScreenMod allows you to change several parameters of any screen
  26. that has been opened.  You can change the TOPEDGE parameter, and the
  27. LEFTEDGE parameter (although at the time of writing, changing the LEFTEDGE
  28. parameter of a screen has no effect since the operating system does not
  29. support it yet, but someday ...).  You can even manipulate the display modes,
  30. such as HAM and HIRES, and adjust the palette of any screen -- even if it
  31. normally does not allow this.
  32.     ScreenMod also allows you to save the changes you've made to a
  33. file, which can then later be called by a companion program called
  34. ScreenSet.  This has been set up so that you can create a batch file
  35. to run your application program first, and then ScreenSet will put any
  36. of the changes you have made into effect.  See the separate ScreenSet
  37. documentation for more details.
  38.  
  39. GETTING STARTED WITH SCREENMOD
  40. ~~~~~~~ ~~~~~~~ ~~~~ ~~~~~~~~~
  41.  
  42.     ScreenMod can be run from the CLI or Workbench, although full
  43. Workbench support has not yet been implemented.  Refer to the "FEATURES
  44. TO BE ADDED" section of this documentation for more details.
  45.     When you first run ScreenMod it will open its own custom screen
  46. using 2 BITPLANES and a RESOLUTION of 640 X 200.  The program contains
  47. an "ICONIFY" feature that will close the main screen and open a small
  48. window in the Workbench title bar.  Normally, this feature is selected
  49. through the SPECIAL menu (or Right-Amiga-I) but ScreenMod can be told
  50. from startup to be iconified.  To do this, when you run the program
  51. just specify the "small" option.  For example:
  52.  
  53. 1>screenmod small
  54.               ^----  This parameter causes ScreenMod to start in an
  55.                      ICONIFIED state.
  56.  
  57.     With this release, starting up in an ICONIFIED state from Workbench
  58. is not possible.
  59.  
  60.     If the program is iconified, and you wish to return it to its full
  61. screen, you must do two things:
  62.  
  63.     1) Activate the small ScreenMod window, by clicking the left button
  64.            somewhere in the title bar.
  65.  
  66.     2) Click the RIGHT BUTTON to tell ScreenMod to UN-ICONIFY.
  67.  
  68. THE MAIN SCREEN
  69. ~~~ ~~~~ ~~~~~~
  70.  
  71.     On the left-hand side of the screen, you will see a listing of
  72. all available screens that are currently opened.  They are ordered the
  73. way the operating system orders screens: The front screen is listed first,
  74. and then the screen behind that one is next, and so on.  Note that the
  75. "SCREENMOD" screen itself will ALWAYS be the first one on the list.
  76.     You will see the NAME of the screen and the RESOLUTION.  If the
  77. screen does not actually have a title, ScreenMod will put in "** NO NAME **"
  78. in it's place.
  79.     To make an alteration to a screen, you first decide which screen
  80. you would like to change, and then click the left button on it's title
  81. on the left-hand side of the screen.  The "settings" will all change
  82. accordingly on the right-hand side.
  83.  
  84. THE PARAMETERS AND WHAT THEY MEAN
  85. ~~~ ~~~~~~~~~~ ~~~ ~~~~ ~~~~ ~~~~
  86.  
  87. LEFT EDGE: The number of pixels the screen is offset from the left.  Please
  88. note this feature is not currently implemented in the operating system,
  89. and changing its value will have no effect.  It DOES however ask the
  90. operating system to make the change so when it is implemented, this program
  91. should still be compatible.
  92.  
  93. TOP EDGE: This is one you may play with a lot.  It indicates the number of
  94. raster lines (pixels) the screen is offset from the top of the display.
  95. For most screens this will be 0, but for some it will be another value.
  96. Try changing ScreenMod's value to say 10, and then REMAKE the screen.
  97.  
  98. WIDTH: The width of the screen, in pixels.  Note that playing with this
  99. parameter will NOT have many useful effects.  If you make the WIDTH
  100. wider than what it normally is, ScreenMod does NOT allocate the extra
  101. memory that would be required.  This would require closing all windows
  102. on the display, closing the screen, then re-opening it with the new
  103. memory allocation and then re-opening the windows -- a daunting task,
  104. especially if the programmer puts things other than standard INTUITEXT
  105. and GADGET structures on the screen (which most do).  If someone has
  106. any thoughts on this, I would love to hear them.  Perhaps it wouldn't
  107. be too hard to allocate the new memory and append it?
  108.  
  109. HEIGHT: This is the height of the screen, in pixels.  The same notes apply
  110. as to the WIDTH, above.  Experimenting with this value can produce some
  111. interesting results though.
  112.  
  113. DETAILPEN: This is the color register number that the operating system
  114. uses when drawing things like the title of the Screen.
  115.  
  116. BLOCKPEN: This is the color register number that the operating system
  117. uses when drawing things like the background of the Screen Title.
  118.  
  119. DEFAULT TITLE & TITLE:  These are simply the name of the Screen.  Keep
  120. in mind that often times the ACTUAL name of the screen is covered up
  121. by a window.  ScreenMod will have no effect on WINDOW titles, only
  122. SCREEN titles.  Secondly, some programs have turned the screen title
  123. OFF to allow a fuller display on the screen (for titling programs and
  124. so on).  ScreenMod will ONLY UPDATE THE TITLE if the program has allowed
  125. the SCREEN TITLE TO SHOW.
  126.  
  127. DEFAULT FONT: This is the default font that this screen uses, but is
  128. not currently supported in this release.
  129.  
  130. And now for the VIEW MODE flags:
  131.  
  132. HIRES: This flag should be turned ON if the screen width is greater than
  133. 320 pixels.
  134.  
  135. INTERLACE: This flag should be turned ON if the screen height is greater
  136. than 200 pixels.  However, it will produce an interesting effect if
  137. turned on when the screen is 200 pixels or less.
  138.  
  139. SPITES: This flag should be turned ON if this screen is to use hardware
  140. sprites.
  141.  
  142. DUALPF: This flag should be turned ON if this screen uses dual playfields.
  143. Dual playfields are often used in games where a "window" is necessary,
  144. like for example the window of an aircraft.  One playfield contains the
  145. cockpit and the other playfield contains a view of the sky and/or ground.
  146. When combined, the user sees the cockpit playfield which is in front,
  147. and sees the sky/ground view playfield ONLY where the "window" of the
  148. cockpit is.
  149.  
  150. HAM: This flag should be turned ON if the screen in question should be
  151. in HAM mode (4096 colors).
  152.  
  153. EXTRA_HALFBRITE: This flag should be turned ON if this program is to use
  154. the extra 32 colors available in EXTRA HALFBRITE mode.
  155.  
  156. *** NOTE: ***
  157.     Just because ScreenMod lets you modify the state of these flags
  158. it does NOT mean that the program running with that screen will take
  159. advantage of the changes.  For example, you can't make DPAINT work in
  160. HAM MODE just by changing the status of the screen.  They are changeable
  161. for experimentation purposes only although you may find some programs
  162. that do neat things because of the changes you make.
  163.  
  164. VIEW SCREEN:  By clicking this gadget, whatever screen you have highlighted
  165. from the list will be moved to the front.  To get back to the ScreenMod
  166. screen, do one of two things:
  167.  
  168.     1) Press any key on the keyboard
  169.     2) Click the RIGHT button.
  170.  
  171.     Clicking the LEFT BUTTON will cause that screens windows to
  172. become active, and then the only way back to the ScreenMod screen will be
  173. with the LEFT-AMIGA-M and LEFT-AMIGA-N keys.
  174.  
  175. ADJUS